Фильтр Формул в формате TeX

Фильтр TeX — это основной фильтр Moodle, предназначенный для преобразования выражений TeX в изображения в форматах GIF, PNG или SVG. Для этого фильтр использует некоторые дополнительные бинарные файлы для обработки выражений, заключённых между соответствующими токенами. Если эти бинарные файлы недоступны, Moodle предоставляет запасной вариант через использование Mimetex. Версии MimeTex для Linux (glib2.3 32bit), Windows, Mac OS X и FreeBSD включены в распределение Moodle. Доступны и другие технологии для отображения Tex (см. раздел о математических инструментах для обсуждения).

Примечание: поскольку фильтр основан на бинарных файлах, он требует наличия трёх функций выполнения программ PHP: exec, shell_exec и system.

Методы и использование

Чтобы избежать путаницы, следует отметить, что фильтр TeX имеет два отдельных метода для преобразования формул TeX в изображения. Более предпочтительный метод — это набор из трёх бинарных файлов, которые вы должны установить (если они ещё не установлены, хотя многие веб-хостинги предоставляют их) и настроить на своём сервере. Страница настроек фильтра полностью посвящена этому методу. Если по какой-либо причине это не удаётся, фильтр переключится на один бинарный файл — MimeTeX. Несколько различных сборок включены в распределение Moodle для популярных операционных систем, хотя Mimetex и его старший брат MathTex достаточно просты в компиляции и установке, если у вас есть опыт администрирования систем.

Прежде чем делать что-либо ещё, вам нужно перейти в Настройки > Администрирование > Плагины > Фильтры и активировать фильтр Формул в формате TeX. Если вы хотите использовать фильтр Алгебры (другой основной фильтр), так как фильтр Алгебры на самом деле является только «внешним интерфейсом» для фильтра TeX, вам также следует включить фильтр Алгебры. Дополнительную информацию о фильтре Алгебры см. в фильтре Алгебры.

После того как фильтр включён и правильно настроен, вы можете использовать его, включив выражение TeX, ограниченное знаками двойного доллара. Пример:

$$ \sqrt{x + y} $$

Если это отображается неправильно, см. информацию об отладке.

MimeTeX

Moodle может использовать предварительно собранный бинарный файл MimeTeX (расположенный в каталоге filters/tex) в качестве запасного варианта, если не удаётся правильно получить доступ к бинарным файлам dvips, convert и latex. Существует несколько различных версий для разных операционных систем. Фильтр TeX выбирает соответствующий бинарный файл для обнаруженной операционной системы хоста (вам придётся внести изменения в скрипт, если ваша операционная система не включена). Обратите внимание, что ваш веб-сервер должен быть настроен с соответствующими разрешениями для запуска бинарных файлов в этом месте.

Руководство MimeTeX доступно, но, вероятно, предназначено для лиц с опытом администрирования систем и не касается конкретно среды Moodle.

Вы должны использовать MimeTeX только в том случае, если установка полной системы LaTeX не удалась или бинарные файлы недоступны в вашей системе. Результаты будут не такими хорошими.

Совместимость с MathJax

В Moodle 2.8 и более поздних версиях фильтры Формул в формате TeX и MathJaxloader могут использоваться в комбинации. Если оба фильтра включены на странице, изображения сначала будут отображаться фильтром Формул в формате TeX, а версия выражения TeX от MathJax заменит их немного позже, когда MathJax завершит загрузку и обработку. Если оба фильтра доступны, преподаватель может решить, какой из них использовать в активности, включив один и отключив другой.

Настройки администрирования сайта

Расположение: ссылка «Настройки формул в формате TeX» в Настройках > Администрирование > Плагины > Фильтры > Управление фильтрами

Страница настроек фильтра TeX предназначена в основном для настройки работы рендерера LaTeX. Значения по умолчанию для трёх настроек пути выбраны в соответствии с обнаружением операционной системы, на которой работает Moodle. Это просто предлагаемые общие значения — Moodle не проверяет, существуют ли бинарные файлы по этим путям. В более новых версиях Moodle рядом с настройкой пути отображается зелёная галочка или красный крестик — это показывает, что бинарный файл существует только в этом месте. Настройки не влияют на работу бинарного файла MimeTex (используется, если любой из этих бинарных файлов не найден).

Установка бинарных файлов

Это зависит от вашей платформы, но для типичной установки вам потребуется реализация LaTeX. В современных реализациях Linux следует искать пакет 'texlive' (например, apt-get install texlive), хотя доступна версия для Windows (см. Tex Live). Маловероятно, что у вас будут все эти бинарные файлы в стандартной установке. Если вы не можете найти texlive, вам, возможно, придётся установить LaTeX, Ghostscript и ImageMagick по отдельности. Хотя Moodle.org этого не одобряет, простой бинарный файл установки для Windows — это MikTeX.

По соображениям безопасности следует убедиться, что оболочка shell escape отключена (shell_escape = f) в вашей конфигурации LaTeX (если она включена, это будет установлено как "t"). Это необходимо для предотвращения риска выполнения внешних команд пользователями. Обратите внимание, что обычно это отключено по умолчанию. (Если это установлено как "p", т. е. в ограниченном режиме, разрешён предопределённый набор команд, если это желаемое поведение, будьте предельно осторожны с тем, какие команды разрешены, учитывая, что все пользователи будут иметь доступ к ним).

Страница настроек фильтра попытается угадать наиболее вероятное расположение бинарных файлов в зависимости от обнаруженной платформы. Если всё верно, зелёные галочки появятся напротив каждой настройки. Если появляются красные крестики, вам необходимо проверить и изменить настройки по мере необходимости. Проводится простая проверка, чтобы установить, существуют ли бинарные файлы по заданным путям. Рядом с каждым отображается галочка или крестик. Обратите внимание, что это не проверяет, работает ли приложение на самом деле, а только то, что оно есть.

Некоторые системы поставляют шрифты в виде отдельных пакетов. Если у вас возникли проблемы, убедитесь, что у вас установлены все необходимые шрифты. Вам может потребоваться найти пакет «дополнительных» шрифтов, чтобы получить нужные математические шрифты.

Преамбула LaTeX

Позволяет указать преамбулу LaTeX. Значение по умолчанию должно работать для большинства пользователей, но вам может потребоваться изменить его для поддержки нестандартных наборов символов и т. д. Дополнительные сведения см. в документации LaTeX.

Цвет фона

Он должен быть установлен в соответствии с вашим обычным цветом фона текста. Значение по умолчанию — #FFFFFF (т. е. белый).

Плотность

Эта настройка влияет на размер полученного изображения. Значение по умолчанию — 120 пикселей, и оно создаёт изображение разумного качества, но для некоторых сложных уравнений этого всё равно может быть недостаточно. Возможно, что меньшее значение не позволит создать изображение достаточного качества, но размер изображения можно контролировать с помощью кодирования TeX при рендеринге страницы.

Путь к бинарному файлу latex

Путь к стандартному бинарному файлу latex.

В системах на базе Unix обычно это "/usr/bin/latex". На MacOS X путь — "/usr/texbin/".

В Windows с использованием MiKTeX обычно это что-то вроде C:\texmf\miktex\bin\latex.exe

Путь к бинарному файлу dvips

Путь к стандартному бинарному файлу dvips — обычно распространяется как часть системы LaTeX.

В системах на базе Unix обычно это "/usr/bin/dvips". На MacOS X путь — "/usr/texbin/".

В Windows с использованием MikTeX обычно это что-то вроде C:\texmf\miktex\bin\dvips.exe

Путь к бинарному файлу convert

Путь к стандартному бинарному файлу convert. Он необходим для создания изображений GIF или PNG с использованием бинарных файлов latex и dvips. Он распространяется как часть системы Ghostscript или ImageMagick в Linux.

В системах на базе Unix обычно это "/usr/bin/convert". На MacOS X путь — "/usr/local/bin/".

На ПК с Windows путь обычно выглядит как C:\Program Files\ImageMagick\convert.exe (для ImageMagick, но что-то другое для GhostScript.)

Путь к бинарному файлу dvisvgm

Этот бинарный файл используется вместо convert для создания SVG-изображений. Он распространяется как часть TeXlive в Linux, хотя для этого может потребоваться установка полных или дополнительных пакетов.

В системах на базе Unix обычно это "/usr/bin/dvisvgm".

На ПК с Windows скомпилированный бинарный файл доступен на sourceforge и может быть помещён в тот же каталог, что и бинарный файл latex.

Путь к бинарному файлу mimetex

Если это поле пустое и вышеуказанные бинарные файлы отсутствуют или не работают, фильтр TeX попытается использовать бинарный файл mimetex, распространяемый вместе с Moodle. Если вы установили mimetex на сервере и предпочитаете использовать его, укажите здесь путь.

Отладка фильтра TeX

У фильтра Te